home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / ulist200.zip / USERLIST.DOC < prev    next >
Text File  |  1990-06-29  |  12KB  |  326 lines
  1.  
  2.  
  3.         USERLIST: v2.00                                   by Stephen de Plater
  4.         June 29, 1990                                      GT Power Net: 302/1
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                        USERLIST
  13.                                  by Stephen de Plater
  14.                                   GT Power Net: 302/1
  15.                               Voice Phone: +61 2 977-3075
  16.                               Data Phone: +61 2 977-2013
  17.  
  18.  
  19.  
  20.  
  21.         ======================================================================
  22.         0.                           REVISION LIST
  23.         ======================================================================
  24.  
  25.         Just to confuse everyone this revision list begins at version 1.10
  26.  
  27.         VERSION:  Release Date:       Comments:
  28.         -------   ------------        --------------------------------------
  29.         1.10      May 21, 1988        GT14 sensitive -- color added. Pathnames
  30.                                       removed, replaced by area  numbers. Area
  31.                                       List  now  optional. Program  returns to
  32.                                       main menu  at the end  of each  listing.
  33.                                       ALL output is now written to stdout --ie
  34.                                       DO  NOT  PIPE  the  output  of  USERLIST
  35.                                       through MORE.
  36.  
  37.         1.11      May 24, 1988        Added  Standard Command  Line Interface.
  38.                                       Added  two  new  options,  disable  FULL
  39.                                       report, and force monochrome.
  40.  
  41.         1.12      June 22, 1988       Added pauses at end of screen.
  42.  
  43.         1.13      August 12, 1988     Added /B parameter.
  44.  
  45.         1.14      October 24, 1988    Added   support   for  an   undocumented
  46.                                       feature  of  GT.  Special color  control
  47.                                       characters in the  GTMDIR.BBS (like  &[]
  48.                                       ..)  while not fully supported, at least
  49.                                       stripped  out.  A bug  in the  search by
  50.                                       name function corrected.
  51.  
  52.  
  53.  
  54.  
  55.                                      >> page 1 <<
  56.  
  57.         USERLIST: v2.00                                   by Stephen de Plater
  58.         June 29, 1990                                      GT Power Net: 302/1
  59.  
  60.  
  61.  
  62.                                       Changed  the  banned  indicator  from  a
  63.                                       rather bland '*' in front of the name to
  64.                                       something  less subtle!  Also recompiled
  65.                                       under Turbo C 2.0.
  66.  
  67.         1.15      November 23, 1988   Added  the "silent" ban feature.  If you
  68.                                       don't  want banned  users shown  at all,
  69.                                       add "*" to your /B parameter.
  70.  
  71.         2.00      June 29, 1990       Finally!  The GT15.xx  release.  This is
  72.                                       a  total  rewrite.    The  features  are
  73.                                       somewhat different and the  command line
  74.                                       parameters  have  changed totally.   The
  75.                                       program  has  also been  moved  to Turbo
  76.                                       C++.
  77.  
  78.  
  79.         ======================================================================
  80.         1.                             COPYRIGHT
  81.         ======================================================================
  82.  
  83.         USERLIST is not placed in the Public Domain. The copyright is retained
  84.         and the software is provided on licence:
  85.  
  86.         You are  free to use  and make as many  copies of this  program as you
  87.         wish. You may also give it away to anyone who wants it, provided:
  88.  
  89.         1.   No fee is charged.
  90.         2.   This archive is distributed intact.
  91.         3.   You register the package with an OZNET registration centre.
  92.  
  93.  
  94.         ======================================================================
  95.         2.                           REGISTRATION
  96.         ======================================================================
  97.  
  98.         A   new  registration  scheme  now  applies  to  all  OZNET  software.
  99.         Regardless  of any  previous registration,  this program  now requires
  100.         individual installation for each BBS using it.
  101.  
  102.         There  is  still NO  fee  involved  at all.  DO  NOT  send any  money!
  103.         Registration  simply  involves  obtaining from  me  a  CRC  code which
  104.         matches your BBS  name.   You may do  this at any  of the seven  OZNET
  105.         registration centres:
  106.  
  107.  
  108.  
  109.                                      >> page 2 <<
  110.  
  111.         USERLIST: v2.00                                   by Stephen de Plater
  112.         June 29, 1990                                      GT Power Net: 302/1
  113.  
  114.  
  115.  
  116.                   Kangaroo Korner          302/001   Stephen de Plater
  117.                   The Black Hole           302/003   Ken Thompson
  118.                   TSUNAMI! Catch the Wave  *TEMPDN   Chet Wilkinson
  119.                   Control Systems          071/001   Ed Cavender
  120.                   Gidget's Domain          081/005   Jack Hazel
  121.                   Fuzzy Logic              050/018   Phill Piddell
  122.                   The Gathering Place      093/000   Joe Tellup
  123.  
  124.         If  you are in  the GTPN nodelist  then you  will be able  to register
  125.         direct online at any of those centres or via  mail in the correct form
  126.         to OZRobot at any of those centres.  See the included OZRobot document
  127.         for details.  If  you are not in the  GTPN net you will need  to apply
  128.         via private  netmail  or  message to  Sysop  at any  of  the  centres.
  129.         Whatever  way  you do  it  you  will need  to  supply  the full  (case
  130.         sensitive) name to which you want the program registered.
  131.  
  132.         You  will also need to obtain  the OZINSTAL program which performs the
  133.         actual installation.   OZINSTAL is not included in  this archive.  You
  134.         should look for OZINST11.ZIP.
  135.  
  136.  
  137.         ======================================================================
  138.         3.                              PURPOSE
  139.         ======================================================================
  140.  
  141.                          (Or what does this thing do anyway?)
  142.  
  143.         USERLIST  is a door  program for GT  Power BBS Systems.  It provides a
  144.         list of users on your system based on one of four selection options:
  145.  
  146.         1.   All users,
  147.         2.   Users on the system since a specified day,
  148.         3.   Users on the system in the last nn days, or
  149.         3.   Users whose names match a (partial) name supplied.
  150.  
  151.         When asked for a name to match, the partial name you enter is not case
  152.         sensitive. And the string which you enter will be searched for in both
  153.         first  and last names. i.e.  "de" will match  "Stephen Deplater" "John
  154.         Della-torre" but not "Ken Thompson".
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.                                      >> page 3 <<
  164.  
  165.         USERLIST: v2.00                                   by Stephen de Plater
  166.         June 29, 1990                                      GT Power Net: 302/1
  167.  
  168.  
  169.  
  170.         ======================================================================
  171.         4.                               USAGE
  172.         ======================================================================
  173.  
  174.         To use USERLIST simply install it as a door much like this:
  175.  
  176.                   @echo off
  177.                   c:
  178.                   cd \gtbbs
  179.                   setdoor ON %1 %2
  180.                   gtdrwy
  181.                   doorway      SYS      /N:     /S:c\gtbbs      /B:MS     /O:T
  182.                        /P:c:\gtbbs\userlist.exe
  183.                   setdoor OFF %1 %2
  184.  
  185.         For the user, all that is  necessary is to open the door and  pick the
  186.         options.
  187.  
  188.         The parameters are all optional and function as follows:
  189.  
  190.         1.   /Hx  Hide high level  users. Lists only users  whose access level
  191.                   is lower than the level given.
  192.  
  193.                   For example: to hide users at or above level "A", use /HA.
  194.  
  195.                   Useful,  perhaps, if you have some high level users you want
  196.                   to hide from the great multitudes who use your board.
  197.  
  198.         2.   /M   Force  monochrome.  Even  if  the  user  has  selected  ANSI
  199.                   graphics, turn the colors off!
  200.  
  201.         3.   /P   Disable Pause. When  this parameter is  set the output  will
  202.                   run  continuously with  no  "more" prompts.  Without it  the
  203.                   program  will  pause at  each  screenful  (see parameter  /C
  204.                   below) and wait for a keystroke.
  205.  
  206.         4.   /Cnn Set  linecount for  screen size.  The  default is  23 lines.
  207.                   There must be no  spaces between the /C and the  number. For
  208.                   instance,  to set  a  screen length  of  15 lines,  use  the
  209.                   parameter /C15.
  210.  
  211.         5.   /Dnn Set the default number  of days in the  date scan. When  the
  212.                   USERLIST main menu option "D"date or "L"ast nn days commands
  213.                   are chosen, the  program will scan  for users either  online
  214.                   since a specified date, or online in the last nn days.  This
  215.  
  216.  
  217.                                      >> page 4 <<
  218.  
  219.         USERLIST: v2.00                                   by Stephen de Plater
  220.         June 29, 1990                                      GT Power Net: 302/1
  221.  
  222.  
  223.  
  224.                   value controls how far back the scan defaults to.   The user
  225.                   can of course change  the number (in either mode).   In both
  226.                   modes  the program will display the default and ask the user
  227.                   to either accept it or enter a different value.
  228.  
  229.                   The default for this parameter is 30 days in both modes.
  230.  
  231.         The  command line  options must  be separated  by white  space, (i.e.:
  232.         "/P/Hx" is not valid, but "/P /Hx" is). They may be in either upper or
  233.         lower  case, and  supplied in  any order.  Also, you  may use  the '-'
  234.         character as the command line parameter flag instead of '/'.
  235.  
  236.         (i.e.: "-P" is fine.)
  237.  
  238.         Users will be returned to this menu after each userlist is displayed.
  239.  
  240.  
  241.         ======================================================================
  242.         5.                              COLORS
  243.         ======================================================================
  244.  
  245.         USERLIST uses the colours you have selected for GT.  If you don't like
  246.         them, don't blame me -- you chose them <grin>!
  247.  
  248.  
  249.         ======================================================================
  250.         6.                            DISCLAIMER
  251.         ======================================================================
  252.  
  253.         Q:         What kind of guarantee comes with this software?
  254.  
  255.         A:                    *** ABSOLUTELY NONE!!! ***
  256.  
  257.         If you break it you get to keep both halves.
  258.  
  259.         I take no responsibility at all  for what this software may do  on any
  260.         computer other than my  own. If you use it you do so at your own risk.
  261.         All that I am prepared to say about it is that it works fine here (and
  262.         I  can see no good reason why it  should not also work fine everywhere
  263.         else also -- but ....)
  264.  
  265.         By using this program you accept these conditions.
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                      >> page 5 <<
  272.  
  273.         USERLIST: v2.00                                   by Stephen de Plater
  274.         June 29, 1990                                      GT Power Net: 302/1
  275.  
  276.  
  277.  
  278.         ======================================================================
  279.         7.                              ENJOY!
  280.         ======================================================================
  281.  
  282.         At least, I hope you do!
  283.         Stephen
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                      >> page 6 <<
  326.